home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
-
-
- *******************************
- * *
- * CMEditor -- Version 3.16 *
- * *
- *******************************
-
-
- Background:
-
- CMEditor was originally written as the editor module for CMFiler, my
- multipurpose disk/file manager designed to bring together and simplify
- 99% of the file management functions you would ever need. I recently
- broke out a standalone version at the urging of several users. If you
- find CMEditor useful and continue to use it beyond a 60-day evaluation
- period, I require that you register your copy for $10. Please read the
- section on registration, and note the benefit of receiving on-disk a
- registered copy of the current version of CMEditor, a copy of the
- shareware version of CMFiler for your evaluation, and, by permission of
- the author, a copy of the shareware version of Integrity Master, the
- outstanding anti-virus and system integrity program by Wolfgang Stiller.
- Note that the versions of CMFiler and Integrity Master provided in this
- offer are for your evaluation and MUST be registered for the fee required
- by the author if you continue to use them beyond a fixed evaluation
- period.
-
- -----
-
- Running CMEditor. . .
-
- First, you may rename CMEDITOR.COM to CE.COM, to reduce the number
- of keystrokes required to run it. Execute CE from the DOS prompt with
- the following command line:
-
- CE FILESPEC [V] [colorparam]
-
- where:
-
- FILESPEC is the specification of the file to be edited,
-
- V is an optional "view-only, no edit" switch, and;
-
- colorparam is an optional color parameter, M, L or T to force more
- readable color sets for Monochrome, LCD and Tandy LCD monitors,
- respectively.
-
-
-
- _____
-
- Record Delimiters. . .
-
- The default display mode for "record delimiters" [carriage return
- (CR), line feed (LF), and the combinations CR+LF and LF+CR] is to show
- their color values, which are cued in the legend at the bottom (blue=CR,
- green=LF, cyan=CR+LF, magenta=LF+CR). In addition , the end of the file
- is denoted with a red End-of-File (EOF) mark. Sometimes it is very useful
- to know exactly what delimiter combination your word processors use, so
- you can duplicate it when you edit with CE. You can toggle the colored
- delimiter symbols off and on with "Alt-Minus" or Gray-. (This is also
- covered in a help screen you can get by pressing Alt-H or F1.)
-
- _____
-
- Information Area. . .
-
- The name of the file being viewed is shown in the lower left prompt
- area. The lower right prompt area shows the ASCII value of the character
- at the cursor (decimal and hex), the position of that character in the
- file (starting with 1), the file record the cursor is in, and the
- position of the cursor within the record (called "Column", which for a
- long record is not necessarily the same as the screen column). This
- information display may be toggled off and on with "Alt-Plus" or Gray+.
-
- _____
-
- Line Wrapping. . .
-
- The default display mode is line wrapping, where any record longer
- than 80 characters is wrapped to the next screen line, so that all text
- is visible. This mode can be toggled (see the Wr/NW -- for "Wrap" or "No
- Wrap" mode -- at upper right for current status) with Alt-W. In the NW
- mode, each record longer than 80 characters simply extends off the screen
- to the right, but is accessible for viewing by putting the cursor on it
- and [Ctrl- or Shift-] Rt Arrow-ing (see below) to any place on the line.
-
- -----
-
- Cursor Movement. . .
-
- The arrow keys move the cursor one line up or down and one character
- left or right. Ctrl-Left/Rt Arrow move left or right one word at a time,
- and Shift-Left/Rt Arrow and Home/End move to the beginning/end of the
- line, as in PCWrite.
-
- PgDn/PgUp moves the display up or down 20 screen lines, and leaves
- the cursor on the same video line. Ctrl-PgUp/PgDn moves the display by
- 200 screen lines (10 video pages) for fast paging through a file. Shift-
-
-
-
- CMEditor -- User's Manual 2
-
-
- Up/Down Arrow moves to the top/bottom of the current page. Alt-B moves
- to the Beginning of the file contents in memory; Alt-E moves to the End.
-
- For very LONG files, exceeding available memory, the editor loads
- only as much as fits. When you get to the end of that section (i.e., the
- current "file contents in memory" referred to above), the next operation
- that asks for another page or line causes the editor to load in the next
- section, remembering the file position of the start of the previous
- section so it can backtrack if you want. (It actually loads the next
- section with some overlap to the previous section, so that a little bit
- of backtracking does not result in reloading the whole previous section.)
- This "heel-and-toe" sequential loading is limited to 50 sections.
-
- _____
-
- Find a String. . .
-
- Want to look for a particular word or string of characters? The
- key combination Alt-F (for "Find") opens up a data window at the
- bottom for you to enter a short string. After you press Enter, CE
- will find the first appearance of the string from the current cusor
- position, and put the cursor on it. Alt-X (for "neXt") finds the
- next appearance, and can be used repeatedly until the string no longer
- appears, which is signalled at the bottom of the screen. The search
- process starts at the cursor location and goes, if necessary, to the end
- of the current file contents in memory.
-
- If the file is long and is being viewed by the editor module in
- sections as discussed above, only the CURRENT section is available to the
- Find operator. The search is case-insensitive.
-
- _____
-
- Leading and Trailing Blanks in the Data Window. . .
-
- The data entry routine truncates leading and trailing blanks, but
- blanks may be included as leading or trailing characters by enclosing the
- string at either or both ends with quotes ("). Suppose, for example, you
- wanted to find all of the appearances in a file of the word "mark", but
- not "remark". Press Alt-F and, in the data entry window enter:
- Find string: >" mark <. This works for the replace string
- as well.
-
- _____
-
- Edit Mode Limitations. . .
-
- CE permits edit mode only if the file fits all at once into available
- memory, has fewer than 16,380 records, and has no record longer than 8190
- bytes. CE will revert to view mode if these conditions are not all
- satisfied. If you have a lot of memory tied up in resident programs or
-
-
- CMEditor -- User's Manual 3
-
-
- RAM disk/cache, then you may not be able to edit extremely large files.
- Chances are, however, that this will never be a practical limitation.
-
- _____
-
- Typeover vs Insert. . .
-
- Look at the upper right. "Vw" means View mode, "T/O" means Edit in
- Typeover mode, "Ins" Insert. Toggle between T/O and Ins with the Insert
- key. Switch from View to Edit mode with Alt-S (for "Switch mode").
- Typing action in Edit mode is just like any other editor, except in
- typeover mode, the Bksp key does not pull the text left. This is to
- avoid unintentionally shortening the file when editing length-sensitive
- files, such as .COM and .EXE files.
-
- _____
-
- Editing a Line. . .
-
- You operate on a line at a time, and the "normal" editing keys work
- -- i.e. Bksp, Del, Tab, Shift-Tab, the unmodified and modified arrow keys
- discussed above, and any ASCII-code keys. To create a new line, just
- Home/End or Shift-Arrow to the beginning or end of the current line,
- depending on whether you want the new line above or below the current
- one, and hit Enter. This inserts the default delimiter combination,
- CR+LF, into the text to set up a new line void of text, but ready for you
- to start typing. The combination Ctrl-Enter gives you a menu screen from
- which you may select a different record delimiter. Join two lines by
- deleting the record delimiter at the end of the first line to be joined.
- Delete a line with Ctrl-Y ("Yank"). Delete from the cursor to the end of
- the line with Ctrl-D. Delete a word and its associated whitespace with
- Ctrl-T.
-
- _____
-
- More on Record Delimiters. . .
-
- On CGA/EGA/VGA monitors, the record delimiter appears as a single
- colored "blank" character at the end of the line, whether it is actually
- two characters (eg., CR+LF) or one (eg., LF). It may be deleted to join
- two lines, but not over-struck -- it always pushes right, even when
- you are in typeover mode. The red "End-of-File" (EOF) marker is not
- actually part of your file, but rather is only a visual aid for you to
- see where the text ends. When the cursor is on the EOF marker, the
- "byte number" in the legend corresponds to the number of the next
- character, if you were to type one. The EOF marker also always pushes
- right, and cannot be deleted. The height of the cursor shows the
- status of the "Caps Lock" switch.
-
-
-
-
-
- CMEditor -- User's Manual 4
-
-
- _____
-
- Alt- Keypad and Alt-N. . .
-
- Any ASCII code from 1 through 255 can be entered from the numeric
- keypad using the Alt- key modifier. A special combination is provided
- for ASCII zero ("NULL"), since "Alt-0" is not recognized by any keyboard
- drivers I have seen. It is "Alt-N" (for "Null").
-
- _____
-
- Block Operations. . .or the REAL Power of CE's Editor. . .
-
- All the block operations -- there are six -- are keyed to Alt- key
- combinations, and they are all intuitive (sort of). They are:
- Alt-{ Mark, Yank (delete), moVe, Copy, Print and Output }.
-
- _____
-
- Marking a Block, and the Copy Buffer. . .
-
- You may also manipulate blocks of records. First mark a block by
- putting the cursor on the first (or last) record of the block you want
- to do something with, press Alt-M (for "Mark"), move down (or up) with
- arrows, PgDn/Up, etc., and mark the last (or first) record of the block,
- again with Alt-M. The marked text is written into a copy buffer for
- later use. If you made a mistake, a third press of Alt-M clears the
- marks, but leaves the copy buffer intact. The contents of this copy
- buffer REMAIN AVAILABLE FOR MULTIPLE USE UNTIL A NEW BLOCK IS MARKED.
-
- When you are marking a block, note that the information box at the
- bottom left of the screen expands to show you the attributes of the
- marked block -- the number of the first and last records marked, and the
- number of bytes in the painted area. There is an arbitrary 32 KB limit
- on the copy buffer.
-
- _____
-
- Delete, Copy, Move. . .
-
- Delete the block with Alt-Y ("Yank"). Or put the cursor in an
- unpainted area of the file, and copy the block into that area, just ahead
- of the line where you put the cursor, by pressing Alt-C ("Copy"). Or
- move it with Alt-V ("moVe"). As noted above, the block previously
- "marked" into the copy buffer is available for multiple use. Just put
- the cursor where you want the block to be copied and hit Alt-C again.
-
-
-
-
-
-
-
- CMEditor -- User's Manual 5
-
-
- _____
-
- Restoring from Inadvertent Block Deletion. . .
-
- If you just deleted a block in error, put the cursor where you want
- to restore it, and press Alt-C to copy the buffer back into the file.
-
- _____
-
- Sending a Block of Text to the Line Printer. . .
-
- Print the copy buffer to line printer 1 (the parallel port) with
- Alt-P ("Print"). After printing, if you want a form feed, press Ctrl-F
- ("Form feed" -- note the use of Ctrl- vice Alt- as the modifier key,
- since Alt-F was already used for "Find").
-
- . . .or to a File. . .
-
- Finally, output the copy buffer to a file in the current path by
- pressing Alt-O (letter "O" for "Output"). A window opens at the bottom
- for typing the name of the file for CE to create (if it doesn't already
- exist) or append to if it does. (The file will be created or opened in
- the current directory on the default drive. Therefore the characters ":"
- and "\" will not be recognized.)
-
- _____
-
- Replace and Global replace. . .
-
- In addition to the Alt-F "find" feature, there is an Alt-R
- "replace" and an Alt-G "global replace" feature. Just press Alt-R or
- Alt-G and enter the find and replace strings when prompted. (If you see
- a mistake in the find string while you are typing the replace string,
- just arrow back up a line and reedit it.) For Alt-R, CE will find the
- first match and ask you to confirm the replacement. It continues finding
- and requesting confirmation until you press Q (for "quit replacing").
- Alt-X reactivates either the find or replace routine, whichever was used
- last. Alt-G replaces all appearances of the find string with no
- confirmation. It may be terminated with any key press. When global
- replace was thus terminated, Alt-X reactivates the confirmatory replace,
- not the global replace.
-
- _____
-
- Leaving CMEditor. . .
-
- After editing is complete, press Esc. The next prompt you get
- asks whether you want to save this edit (y/n), or go back to the editor
- (Esc). (If you had hit the Esc key by mistake, hit it again to
- return to where you were.) In some cases you botched the file up so bad
- you don't want to save it, but most of the time you do. Press Y. The
-
-
- CMEditor -- User's Manual 6
-
-
- next prompt wants to know if you want to save the original, pre-edit
- version of the file as "*.BKP" (an arbitrary extension designator I
- picked to show the file as a "BacKuP" from edit mode, different from the
- form of the backup extension assigned by the backup command B from the
- main module.) If you say no, the edited version will simply overwrite
- the original. If you say yes, then the previous backup file with the
- same name and extension ".BKP", if there is one, will be deleted, the
- "current" original file will be renamed with the ".BKP" extension, and
- the now-edited version will be saved under the original name. If CE runs
- out of file space, it will ask you to put a NEW disk into drive A to save
- the edited version.
-
- CE also automatically records the state of four parameters to be the
- defaults for the next time it is executed. These are the show-delimiter
- and show-bottom-display switches, the typeover/insert mode, and the line-
- wrap mode.
-
- _____
-
- Backup File Protection. . .
-
- A small point of backup file protection. If, in the process of
- saving the original version of the edited file, CE encounters a file
- with the same name and the ".BKP" extension, it will simply overwrite
- it, UNLESS it is assigned the read-only attribute and the original to
- be renamed and saved is not. In this case CE will give you the option
- of saving the read-only file.
-
- _____
-
- Help. . .
-
- A one-page help screen may be summoned on-line at any time in the
- editor with the command F1 or Alt-H, and exited with any keystroke.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- CMEditor -- User's Manual 7
-
-
-
-
-
-
- *******************************
- * *
- * CMEditor -- Version 3.16 *
- * *
- *******************************
-
-
- REGISTRATION INFORMATION:
-
- Definition of Shareware. . .
-
- Shareware distribution gives users a chance to try software
- before buying it. If you try a Shareware program and continue
- using it, you are expected to register. Individual programs
- differ on details -- some request registration while others
- require it, some specify a maximum trial period. With
- registration, you get anything from the simple right to continue
- using the software to an updated program with printed manual.
-
- Copyright laws apply to both Shareware and commercial software,
- and the copyright holder retains all rights, with a few specific
- exceptions as stated below. Shareware authors are accomplished
- programmers, just like commercial authors, and the programs are
- of comparable quality. (In both cases, there are good programs
- and bad ones!) The main difference is in the method of
- distribution. The author specifically grants the right to copy
- and distribute the software, either to all and sundry or to a
- specific group. For example, some authors require written
- permission before a commercial disk vendor may copy their
- Shareware.
-
- Shareware is a distribution method, not a type of software. You
- should find software that suits your needs and pocketbook,
- whether it's commercial or Shareware. The Shareware system makes
- fitting your needs easier, because you can try before you buy.
- And because the overhead is low, prices are low also. Shareware
- has the ultimate money-back guarantee -- if you don't use the
- product, you don't pay for it.
-
- _____
-
- Ombudsman Statement. . .
-
- This program program is produced by a member of the Association of
- Shareware Professionals (ASP). ASP wants to make sure that the shareware
- principle works for you. If you are unable to resolve a shareware-related
- problem with an ASP member by contacting the member directly, ASP may be
- able to help. The ASP Ombudsman can help you resolve a dispute or problem
- with an ASP member, but does not provide technical support for members'
- CMEditor - Registration 8
-
-
- products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon,
- MI 49442 or send a CompuServe message via CompuServe Mail to ASP
- Ombudsman 70007,3536.
-
- _____
-
-
- CMEditor Disclaimer - Agreement. . .
-
- Users of CMEditor must accept this disclaimer of warranty: CMEditor
- is supplied as-is. The author disclaims all warranties, expressed or
- implied, including, without limitation, the warranties of merchantability
- and of fitness for any purpose. The author assumes no liability for
- damages, direct or consequential, which may result from the use of
- CMEditor.
-
- _____
-
- Registration. . .
-
- CMEditor is a copyrighted Shareware program by Charles F. Martin,
- President, NoVaSoft and author member of the Association of Shareware
- Professionals. The evaluation version of CMEditor is offered at no charge
- to any potential user for evaluation. Feel free to share it with your
- friends, but please do not give it away altered or as part of another
- system. The essence of "user-supported" software is to provide personal
- computer users with quality software without high prices, and yet to
- provide incentive for programmers to continue to develop new products.
-
- If you find this program useful and find that you are using CMEditor
- after a 60-day trial period, you must make a registration payment of $10.
- Checks may be made payable to Charles F. Martin or NoVaSoft. You will be
- sent by return mail a registered copy of the latest version of CMEditor
- with hard copy of the user's manual. You are entitled to have as many
- copies of it as you wish (for example, one on each computer you use at
- home and work, plus one for your briefcase), with the understanding that
- these are for YOUR personal use and demonstration to others. Please
- recognize that this is a CONSIDERABLY relaxed condition on copying and
- usage than some authors specify. It is done for YOUR convenience.
-
- Registration also entitles you to user support by mail or CompuServe
- E-mail for at least one year, to a free copy by mail of the current
- registered version of CMEditor, and on-disk copies of the shareware
- versions of my disk/file manager CMFiler, and, by permission of the
- author, Wolfgang Stiller's outstanding anti-virus/system integrity
- package Integrity Master. Please note that these latter two programs are
- for evaluation only, and must each be registered for a fee with the
- author if you continue to use them beyond a period of evaluation set by
- the author.
-
- Prospective commercial users of CMEditor may contact the author to
- arrange for a site license.
-
- CMEditor - Registration 9
-
-
- Distributors and BBS sysops recognized by the Association of
- Shareware Professionals (ASP) as adhering to its guidelines for shareware
- distributors may begin offering CMEditor in their catalogs/BBS services
- immediately, and will automatically receive updates by mail by virtue of
- their ASP membership. Other distributors whose only remuneration is a
- nominal fee for the disk itself, and whose literature makes it clear to
- their buyers that the program material must be separately purchased from
- the author, may also offer CMEditor immediately, but should inform me so
- that I can provide them periodic updates. Distributors who wish to sell
- CMEditor packaged as or in a retail product must contact me, and are not
- authorized to distribute this version of CMEditor.
-
-
-
- Charles F. Martin
- President, NoVaSoft
- 3239 Riverview Dr.
- Triangle, VA 22172-1421 USA
-
- Phone (703) 221-1471 or 221-1833
- CompuServe 72130,1400
- Internet 72130.1400@compuserve.com
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- CMEditor - Registration 10
-
-
- ------------------- CMEditor REGISTRATION FORM -----------------------
- [Make checks payable to Charles F. Martin or NoVaSoft]
- [Mail to 3239 Riverview Dr., Triangle, VA 22172-1421 USA]
-
-
- ______________________________________________________________________
- Name of Registrant Date
-
- ______________________________________________________________________
- Street
-
- ______________________________________________________________________
- City State Zip
-
- Enclosed is $10 to register my copy of CMEditor Version 3.16. (Make
- checks payable to Charles F. Martin or NoVaSoft.) I understand I will
- receive user support by mail for at least one year. CompuServe
- subscribers may receive their user support by CIS E-mail.
-
- My CIS User ID is:____________________________________________________
-
- I also understand I will receive on disk a copy of the current registered
- version of CMEditor, and shareware copies of CMFiler and Wolfgang
- Stiller's Integrity Master anti-virus/system integrity package. I
- understand that these latter two programs are for my evaluation only, and
- that I must register each separately with the respective author if I
- continue to use either/both beyond the authors' defined evaluation
- period.
- _ _
- Specify: |_| 5.25" DSDD |_| 3.5" DSDD floppy disk
-
- I also have the following suggestions for improving CMEditor, or have
- found the following bugs (attach additional sheets if needed):
-
-
- ______________________________________________________________________
-
-
- ______________________________________________________________________
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- CMEditor - Registration Form
-